home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 034a / king715u.zip / KING.DOC < prev    next >
Text File  |  1992-01-22  |  12KB  |  241 lines
  1.                              King of the Board
  2.                  Copyrighted June 1988,1989,1990,1991,1992
  3.                    By Chuck Valecek - Suburban Software
  4.                                Version 7.15
  5.                               Janurary 22, 1992
  6.  
  7. BACKGROUND
  8.  
  9.     King of the Board started about a year ago as a Door written in 
  10. QuickBasic, and incorporated Door routines in DOORPATCH. Since then, 
  11. it has been modified from version 1.0 through 5.4 with suggestions 
  12. by users and Sysops. It has become very popular with PCBoards all 
  13. over the country and very popular with the users.
  14.  
  15.     The 7.0 was the first official release of the door which was completly
  16. rewritten using Turbo Pascal and ProKit Door routines. This will, I hope,
  17. satisfy those Sysops who wanted to use the door but could not, due to
  18. the newer modem speeds and system incompatibilities.
  19.  
  20. FILES
  21.  
  22. The following files are either included in the package or created by the door.
  23.  
  24. KINGxxx.EXE  The door program itself (xxx would be the version number)
  25. QUESTION.DAT Question file (included)
  26. QUESTION.TXT Question file in text format
  27. NEXTQUES.DAT Next question (created by the door)
  28. NEW_QUES.DAT New questions entered by the users (created by the door)
  29. KINGUTIL.EXE Utility program to list users etc (included)
  30. KINGxxx.CNF  Sample config file
  31. KINGxxx      Sample batch file
  32. KING.LOG     Optional log file (created by the door)
  33. KING.HLP     Help file
  34. KINGP.HLP    Help file if using the Point version.
  35. KOB.DAT      Sign on screen for King
  36. QOB.DAT      Sign on screen for Queen
  37. MKKOB715.EXE Program to create the config file for Version 7.08
  38. KINGQUES.EXE Program to add questions quickly
  39.  
  40.  
  41. THE DOOR
  42.  
  43.     King is a trivia game in which users try to make it up the pyramid
  44. to the top. To accomplish this, the user must challenge another user 
  45. in a position above him. The user is asked a question and if he gets 
  46. it right he changes places with the user he challenged. It's a quick 
  47. game and won't tie up your board as some games do, because the user is 
  48. asked only one question and is allowed only one play per day. He may 
  49. call back tomorrow and find himself back were he was or even further
  50. down the pyramid. If the user is beyond the playing grid (only 28 
  51. users on the grid) he can challenge only the 26th, 27th, and 28th 
  52. positions. If he is on the grid he can only challenge one of the next 
  53. three players. After the player has a turn he is asked if he would 
  54. like to enter a qustion into the game. These questions are placed in 
  55. a hold file for the sysop to review and merge into the question 
  56. file. Each time a user calls in the question is changed. The program 
  57. reads the question file sequentially so the more questions in the 
  58. file the less chance the user will get a repeat. The sysop also has 
  59. the option to limit the number of chances the user gets to answer 
  60. correctly. I use 3 and it seems to work out just fine. One sysop, I 
  61. won't mention his name, changes the number of chances, so his users 
  62. never know how many tries they get. The format of the question is 
  63. shown to the user. All alpha characters are replaced with a *, all 
  64. digits are replaced with a N and special characters (!@#$$%) are 
  65. shown as is. After each guess the user is prompted to see if he 
  66. would like to try again. If so, the correct letters are replaced so 
  67. as to give him a hint. This helps if the user is unsure of the 
  68. correct spelling. Only letters that are in the correct position are 
  69. replaced.
  70.  
  71.  
  72.    There is an option that allows the sysop to choose whether he 
  73. wants the game to use a point system. The point system assigns a 
  74. point value to the person being challenged. The points are assigned 
  75. as follows: A person 3 positions above the player is worth 2500 
  76. points. A person 2 positions above the player is worth 2000 points. 
  77. A person 1 position above the player is worth 1500 points.
  78.  
  79. If the player answers the question incorrectly the person he 
  80. challenged gets a bonus of 500 points.
  81.  
  82. If you choose to set the point option, an extra file will be created 
  83. by the door which will contain the point standings. This will only 
  84. appear if the point option is set. The user will also be asked if he 
  85. would like to review the file before the door terminates. If you 
  86. wish, this file could be copied over as a bulletin in the door batch 
  87. file.
  88.  
  89. Just add "copy kingpts c:\pcb\gen\bltnn" and "copy kingptsg c:\pcb\gen\bltnng
  90. in your batch file before you return to the board.
  91.  
  92.  
  93.  
  94.    That's about it for the door operation. It's simple yet fun!
  95.  
  96. SETUP
  97.  
  98.     Most of you out there are familiar with the setup of a door. This door 
  99. follows the standard setup of the ProKit series of Doors.
  100.  
  101.  
  102. Since the config file has gotten so large, I have written a program that will
  103. create the config file for you through a series of prompts. Answer the prompts
  104. and a config file will be created. You can always rerun the program to create 
  105. another file if you made an error.
  106.  
  107. If you are a previous registered sysop of King of the Board your old 
  108. registration number will work with this door.
  109.  
  110.  
  111. And you thought it was hard!
  112.  
  113. Okay, now to set up a batch file for the door to run. Remember this is just like
  114. any other batch file except there is no ".BAT" extension.
  115.  
  116. The standard DOOR script for ProKit doors has this format:
  117.      echo off
  118.      cd \king
  119.      KINGxxx KINGxxx.CNF c:\pcb
  120.      copy KINGPTS C:\PCB\GEN\BLT30  (Only if the points are in effect) OPTIONAL
  121.      copy KINGPTSG C:\PCB\GEN\BLT30G (Only if the points are in effect) OPTIONAL
  122.      cd \pcb
  123.      board
  124.  There is nothing else required in this batch file.
  125.  
  126.  
  127. UTILITIES
  128.  
  129. Okay, now to the new Sysops. There is a program called KINGUTL4.EXE. This 
  130. utility will display the users file, print the users file, Purge users from the users
  131. file, Verify the question file (explained later), Merge the new questions into
  132. the question file, Create a TEXT file from the question file for editing and
  133. rebuild the question file from a TEXT file. Since the question file is a
  134. formatted Pascal file it may look like gibberish to you. Choosing the option
  135. Convert to text will allow you to use any text type editor and edit the questions
  136. or answers, and then rebuild the question file. All the options are 
  137. in LOTUS type menus. Select the option with the arrow keys and press 
  138. return.
  139.  
  140.     The questions entered by the users go into a file called NEW_QUES.DAT.
  141. This is a standard text file and can be edited with any text editor. Edit this
  142. file before merging the new questions into the question file.
  143. The format of the data is question,answer,user. That is the question followed
  144. by a comma followed by the answer followed by a comma followed by the username.
  145. As of this release all three (3) fields must be present. The KINGUTIL will strip
  146. off the users name before it is merged.
  147.  
  148.     If you convert the question file into a text file, the first line will be 
  149. the number of questions in the file. Example: 1147,0. There is no need to change 
  150. this record. Leave as it is the KINGUTIL will place the correct number of 
  151. questions in the first record. Why this record? The door creates a file called
  152. NEXTQUES.DAT that contains the number of the next question. If this number
  153. exceeds the number of questions it will reset to 2 allowing the first question
  154. to be asked. In future release this may be removed and a editor built into the
  155. KINGUTIL to accomodate editing of the questions. But for now this is the way
  156. it has to be.
  157.     
  158.     PLEASE edit your new question file!!! I have had users call me long
  159. distance to complain that they lost because of a word was entered incorrectly.
  160. This is not MY problem. It's up to you to insure that the answers are correct.
  161.  
  162.     I believe I have tried to cover most of the requirements of the programs.
  163. Sample config files, batch files and questions have been included in the 
  164. package.
  165.  
  166. REGISTRATION
  167.  
  168.     If you wish to register the door it would be greatly appreciated. For a
  169. mere $20.00 you can get rid of that stupid message <EVALUATION COPY> and
  170.  
  171.     $$$$ Please help the sysop Register this door $$$ 
  172.    
  173.     I will contact you by BBS or mail you the latest version of the door along
  174. with a registration number. This number will turn off the messages and allow
  175. your BBS name to be displayed on the opening and closing screens. As I stated 
  176. before this door is not Crippled in any way or form and will run forever even
  177. if you did not register it. All monies received go back to other Door Authors
  178. for their doors that run on my system, the latest version of Pascal etc. In
  179. the past I have contacted registered sysops and uploaded the newest versions.
  180. It has become almost impossible for me to continue this practice since there 
  181. have been so many registrations. I always have a open door for sysops on my
  182. board. Sign in and go into my Support Confrence and you will find the latest
  183. version of my doors there for downloading.
  184.  
  185.     Please if you have a problem with setting it up or find a bug (?) Don't 
  186. call Salt Air and gripe about it, call my board and you will get a FASTER
  187. response. I know there are some Sysops out there that can vouch for this. I
  188. called many Sysops voice and tried to help them out at my expense, even before
  189. they registered the door.
  190.  
  191.     If you are a Author of a door and want to exchange registered copies let
  192. me know. We can work out something!! I may even throw my kids into the deal!
  193.  
  194. OH! One more thing. If you have any suggestions, please drop me a line. Please
  195. direct all complaints about the door to my wife, I am trying to get even with
  196. here!!!
  197.  
  198. All the changes to the door in the past year have been suggestions made by 
  199. sysops who have registered the door. I will review all suggestions and if they
  200.  have any merit I will incorporate them in the next 
  201. release or so. If time permits I will compile a list of suggestions that have
  202. not yet made it into the code for you to review and voice your opinion on.
  203.  
  204.  
  205.     I would like to take a few lines and thank those who made this 
  206. door possible: Clark Development for writing the BEST BBS program 
  207. out, Sam Smith for doing such a GREAT job on the routines used in 
  208. this door and to all of you that have taken the time to register the 
  209. door and have added suggestions to the door. 
  210.  
  211.    I have made a request to the authors of PCBoard to be placed on the
  212. list of 3rd party authors and software developers. Hopefully I can receive the
  213. file layouts for 15.0 as soon as they are finalized. This will allow me to 
  214. the necessary changes before everyone is on 15.0.
  215.  
  216.    And a special Thanks to Howard Hartman of Network East, Heather Broadhurst 
  217. for the edited question file, Israel Silverman, Sysop of The Round Table BBS
  218. for editing this doc file so it is more "readable" and to all the sysops who 
  219. have help me test the beta release and for thier suggestions.
  220.  
  221.    If you have an idea that you would like to see turn into a door. Drop me a 
  222. line and we can discuss your ideas. And maybe turn it into a door!!
  223.  
  224.  
  225. Okay here is the address to send the MILLIONS!!
  226.  
  227. Chuck Valecek
  228. Suburban Software
  229. P. O. Box 368
  230. Oak Lawn, IL 60454
  231. (708)-636-6694 (Node 1) (708)-636-6697 (Node 2) USR HST 19200
  232. I am PcPursuitable via Chicago
  233.  
  234. Effective November 1989 our area code was changed from 312 to 708 so please make
  235. a note of it. Oh! Please make the checks or money order payable to me not
  236. Suburban Software. Believe it or not my bank won't cash them unless I open a 
  237. business account.
  238.  
  239. Watch for King of the Board version 8.0 due out in the early part of 1992. This
  240. release will be a complete rewrite of the door and will support most major
  241. BBS software packages.